LocalConnection.onStatus

Доступность

Flash Player 6.

Синтаксис

sending_lc.onStatus = function(infoObject:Object) : Void{
  // ваш код
}

Параметры

infoObject Параметр, зависящий от статуса соединения. Для более подробной информации смотри раздел раздел Описание.

Возвращает

Ничего.

Описание

Обработчик события; вызывается после попытки передачи сообщения объектом-отправителем объекту-получателю. Если Выхотите определить обработчик события, Вы создать функцию, обрабатывающую данные, возвращаемые объектом LocalConnection.

Если информационный объект, возвращаемый обработчику события, имеет свойство status равное level, Flash успешно передал запрос объекту-получателю. Однако это вовсе не означает, что Flash успешно вызвала указанный метод; это значит только то, что Flash смогла передать запрос. Например, метод не вызывается, если объект-получатель не разрешил исполнение запросов из данного домена или метод попросту не существует. Единственный способ до конца убедиться в том, что .

Если информационный объект, возвращаемый обработчику события, свойство level, равное error, Flash не смогла отправить запрос, скорее всего из-за того, что ни один объект-приемник не использует того же имени соединения, что было передано методу sending_lc.send().

В добавок к обработчику onStatus, Flash предоставляет "глобальный" обработчик System.onStatus. Если onStatus вызывается для определенного объекта, а указанного метода не существует, Flash выполняет функцию, присвоенную System.onStatus, если таковая существует.

В большинстве случаев Вы будете использовать этот обработчик только для контроля ошибок, как показано в следующем примере.

Пример

В следующем примере выводится, подключился ли объект к другому объекту LocalConnection, lc_name. Для отображения результата используются компонент TextInput name_ti, компонент TextArea status_ta и компонент Button send_button.

var sending_lc:LocalConnection;
var sendListener:Object = new Object();
sendListener.click = function(evt:Object) {
  sending_lc = new LocalConnection();
  sending_lc.onStatus = function(infoObject:Object) {
    switch (infoObject.level) {
    case 'status' :
      status_ta.text = "Соединение по LocalConnection успешно установлено.";
      break;
    case 'error' :
      status_ta.text = "Соединиться по LocalConnection не удалось.";
      break;
    }
  };
  sending_lc.send("lc_name", "sayHello", name_ti.text);
};
send_button.addEventListener("click", sendListener);

См. также

LocalConnection.send(), System.onStatus